From c9af14678ef5a89dbeefdfce0676145eb4cd572e Mon Sep 17 00:00:00 2001 From: =?utf8?q?Javier=20Jard=C3=B3n?= Date: Sun, 17 Apr 2011 23:34:41 +0100 Subject: [PATCH] Move documentation to inline comments: GtkTextMark --- docs/reference/gtk/tmpl/.gitignore | 1 + docs/reference/gtk/tmpl/gtktextmark.sgml | 141 ----------------------- gtk/gtktextmark.c | 37 ++++++ 3 files changed, 38 insertions(+), 141 deletions(-) delete mode 100644 docs/reference/gtk/tmpl/gtktextmark.sgml diff --git a/docs/reference/gtk/tmpl/.gitignore b/docs/reference/gtk/tmpl/.gitignore index 8bc887a70a..4e2564dd71 100644 --- a/docs/reference/gtk/tmpl/.gitignore +++ b/docs/reference/gtk/tmpl/.gitignore @@ -110,6 +110,7 @@ gtktable.sgml gtktearoffmenuitem.sgml gtktesting.sgml gtktextiter.sgml +gtktextmark.sgml gtktexttag.sgml gtktexttagtable.sgml gtktextview.sgml diff --git a/docs/reference/gtk/tmpl/gtktextmark.sgml b/docs/reference/gtk/tmpl/gtktextmark.sgml deleted file mode 100644 index a15b76271f..0000000000 --- a/docs/reference/gtk/tmpl/gtktextmark.sgml +++ /dev/null @@ -1,141 +0,0 @@ - -GtkTextMark - - - -A position in the buffer preserved across buffer modifications - - - -You may wish to begin by reading the text widget -conceptual overview which gives an overview of all the objects and data -types related to the text widget and how they work together. - - - -A #GtkTextMark is like a bookmark in a text buffer; it preserves a position in -the text. You can convert the mark to an iterator using -gtk_text_buffer_get_iter_at_mark(). Unlike iterators, marks remain valid across -buffer mutations, because their behavior is defined when text is inserted or -deleted. When text containing a mark is deleted, the mark remains in the -position originally occupied by the deleted text. When text is inserted at a -mark, a mark with left gravity will be moved to the -beginning of the newly-inserted text, and a mark with right -gravity will be moved to the end. - - - -"left" and "right" here refer to logical direction (left is the toward the start -of the buffer); in some languages such as Hebrew the logically-leftmost text is -not actually on the left when displayed. - - - - - -Marks are reference counted, but the reference count only controls the validity -of the memory; marks can be deleted from the buffer at any time with -gtk_text_buffer_delete_mark(). Once deleted from the buffer, a mark is -essentially useless. - - - -Marks optionally have names; these can be convenient to avoid passing the -#GtkTextMark object around. - - - -Marks are typically created using the gtk_text_buffer_create_mark() function. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -@name: -@left_gravity: -@Returns: - - - - - - - -@mark: -@setting: - - - - - - - -@mark: -@Returns: - - - - - - - -@mark: -@Returns: - - - - - - - -@mark: -@Returns: - - - - - - - -@mark: -@Returns: - - - - - - - -@mark: -@Returns: - - diff --git a/gtk/gtktextmark.c b/gtk/gtktextmark.c index b9fb6377fd..33b0649a6f 100644 --- a/gtk/gtktextmark.c +++ b/gtk/gtktextmark.c @@ -54,6 +54,43 @@ #include "gtkintl.h" +/** + * SECTION:gtktextmark + * @Short_description: A position in the buffer preserved across buffer modifications + * @Title: GtkTextMark + * + * You may wish to begin by reading the text widget + * conceptual overview which gives an overview of all the objects and data + * types related to the text widget and how they work together. + * + * A #GtkTextMark is like a bookmark in a text buffer; it preserves a position in + * the text. You can convert the mark to an iterator using + * gtk_text_buffer_get_iter_at_mark(). Unlike iterators, marks remain valid across + * buffer mutations, because their behavior is defined when text is inserted or + * deleted. When text containing a mark is deleted, the mark remains in the + * position originally occupied by the deleted text. When text is inserted at a + * mark, a mark with left gravity will be moved to the + * beginning of the newly-inserted text, and a mark with right + * gravity will be moved to the end. + * + * + * "left" and "right" here refer to logical direction (left is the toward the start + * of the buffer); in some languages such as Hebrew the logically-leftmost text is + * not actually on the left when displayed. + * + * + * Marks are reference counted, but the reference count only controls the validity + * of the memory; marks can be deleted from the buffer at any time with + * gtk_text_buffer_delete_mark(). Once deleted from the buffer, a mark is + * essentially useless. + * + * Marks optionally have names; these can be convenient to avoid passing the + * #GtkTextMark object around. + * + * Marks are typically created using the gtk_text_buffer_create_mark() function. + */ + + static void gtk_text_mark_set_property (GObject *object, guint prop_id, const GValue *value, -- 2.30.2